home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / examples / dtscreen / README.z / README
Encoding:
Text File  |  2003-11-18  |  4.5 KB  |  98 lines
  1.  
  2. This directory contains demonstrations of the Dt Screen Saver API
  3.  
  4. screensaver -    Example of a simple screen saver that uses the DT Screen
  5.         Saver API and techniques to make that screen saver
  6.                 available to all desktop users or your own session.
  7.  
  8.                 The desktop provides a set of screen savers for use
  9.                 in desktop sessions. This set of screen savers can
  10.                 be previewed and selected from the Style Manager Screen
  11.                 dialog. 
  12.  
  13.                 Each screen saver is known to the desktop by the screen
  14.                 saver's action definition. The screen saver's action 
  15.                 definition provides the desktop with a short localizable
  16.                 title for the screen saver, as well as the command line
  17.                 and options required to start the screen saver. When the
  18.                 desktop starts a screen saver, it is started by invoking a
  19.                 screen saver action. 
  20.  
  21.                 The set of screen saver actions available to a user's 
  22.                 desktop session is defined by the DTSCREENSAVERLIST
  23.                 environment variable. The default DTSCREENSAVERLIST
  24.                 set is defined when you start a desktop session. A
  25.                 system administrator can change this set by creating
  26.                 a script in directory /etc/dt/config/$LANG/Xsession.d 
  27.                 that modifies DTSCREENSAVERLIST. A user can do the
  28.                 same in their $HOME/.dtprofile.
  29.  
  30.                 A desktop screen saver is a simple application that
  31.                 uses the DtSaverGetWindows() API to obtain a list of
  32.                 windows, and draws on those windows. The desktop handles
  33.                 the starting and stopping of the screen saver application.
  34.               
  35.                 The 'screensaver' application is an example that shows 
  36.                 how the DtSaverGetWindows() API may be used, how the 
  37.                 screen saver action may be defined for 'screensaver' and
  38.                 how the screen saver can be integrated into the desktop for
  39.                 all desktop users or an individual desktop user. The screen
  40.                 saver action is named SampleScreenSaver and is defined in
  41.                 /usr/dt/examples/dtscreen/dt/appconfig/types/C/screensaver.dt.
  42.  
  43.                 Making the screen saver available to all users
  44.                 ----------------------------------------------
  45.                 You must be root to make the screen saver available
  46.                 to all users. This example assumes you are building
  47.                 'screensaver' directly in /usr/dt/examples/dtscreen.
  48.  
  49.                 1) Build the 'screensaver' application
  50.       
  51.                    make -f Makefile.<platform>
  52.  
  53.                 2) Register the screen saver action with the desktop
  54.  
  55.                    dtappintegrate -s /usr/dt/examples/dtscreen
  56.  
  57.                 3) Add the screen saver action to the list of available savers
  58.  
  59.                    #create file /etc/dt/config/Xsession.d/myvars containing:
  60.                    DTSCREENSAVERLIST="SampleScreenSaver $DTSCREENSAVERLIST"
  61.  
  62.                 4) Make the /etc/dt/config/Xsession.d/myvars file executable:
  63.  
  64.                    chmod 755 /etc/dt/config/Xsession.d/myvars
  65.  
  66.                 The next time a user starts the desktop, the example screen
  67.                 saver will be available for use.
  68.                      
  69.                 Making the screen saver to your own desktop session
  70.                 ---------------------------------------------------
  71.                 1) Copy the screen saver example to $HOME/dtscreen
  72.  
  73.                    cp -r /usr/dt/examples/dtscreen $HOME/dtscreen
  74.                    cd $HOME/dtscreen
  75.  
  76.                 2) Build the 'screensaver' application
  77.  
  78.                    make -f Makefile.<platform>
  79.  
  80.                 3) Register the screen saver action with the desktop
  81.  
  82.                    cp $HOME/dtscreen/dt/appconfig/types/C/screensaver.dt \
  83.                      $HOME/.dt/types
  84.  
  85.                 4) Change the action EXEC_STRING path
  86.  
  87.                    vi $HOME/.dt/types/screensaver.dt
  88.                    #change the EXEC_STRING to '<home>/dtscreen/screensaver',
  89.                    #replacing <home> with the value of $HOME
  90.  
  91.                 5) Add the screen saver action to the list of available savers
  92.  
  93.                    #edit $HOME/.dtprofile and add:
  94.                    DTSCREENSAVERLIST="SampleScreenSaver $DTSCREENSAVERLIST"
  95.  
  96.                 The next time a user starts the desktop, the example screen
  97.                 saver will be available for use.
  98.